Summary

Content "Layering items and item variants on specific furniture and terrain"

Purpose of change

fixes #52616

Describe the solution

Implements a new unsorted map per tileset that reads from a file called layering.json if it is available and stores additional info for the tile to layer items when doing render calls. #52616 more clearly explains the what and why.

I believe this now works correctly and renders as would be expected

Describe alternatives you've considered

A few details of implementation could be modified. For displaying weighted overlays consistently I've added a random seed per item. That could instead be per tile, furniture piece etc.

Somehow I'm sure this could be coupled more deeply into the data / json but since it is tileset specific I think it should live there.

Testing

Load up the game, build a desk, put a laptop and a pen on the desk.

use this ultica_custom that contains mock ups to test the functionality
ultica_custom.zip

Additional context

Here are some tests using mockup layering sprites I have a single laptop layer sprite and 2 pen sprites. There is an equal chance a pen will be the left side or right side sprite. (for mockup purposes only one has the black underline usual to Ultica):

Just drawing laptops and pens on top of the desk even at a distance:

You get the highlight for additional items when close enough to see in the container:

If the topmost item is not already been rendered as a layer sprite it will also draw on the tile as normal (in this case a combat knife):